home *** CD-ROM | disk | FTP | other *** search
/ Amiga News 96 / Amiga News 96.iso / amig_ad_os / avm / avminstall / docs / installation < prev    next >
Encoding:
Text File  |  1978-01-01  |  17.2 KB  |  431 lines
  1.  This file documents how to set up avmNfax.  Please read it carefully.
  2.  After installing, please read the full documentation (avm.doc
  3.  or avm.guide).  Then read Registration or Registration.guide to
  4.  get some information on what the Unregistered version can do
  5.  and how to get yourself registered.
  6.  
  7.  If you are upgrading from a previous version of avmNfax, you need
  8.  to go through these steps again.  The AVM-Install script will detect
  9.  whether you have previously installed avmNfax and will be able
  10.  to save your previous configuration (if you want to).
  11.  WARNING:  If you do choose to keep your current setup, I recommend
  12.  that you look in avm:Defaults/LineLink144e.StandardConfig (if you
  13.  have a LineLink), avm:Defaults/Zyxel612.StandardConfig (if you have
  14.  a ZyXEL with a ROM version greater than or equal to 6.12), or
  15.  avm:Defaults/Any.StandardConfig for all other modem types.  In
  16.  particular, look at the *end* of the file to see if there are new
  17.  things that I added that are user-settable.  Also go through the
  18.  History file to see if I added any new flags for your modem's type.
  19.  
  20.  USR Sportster Vi users!  There are two configurations that may work
  21.  for you.  Try the first one.  If it doesn't work for you, then
  22.  go into the AVMSuite2 window using the WorkBench, double-click on
  23.  the DefaultScripts drawer, and then double-click on the "useUSRVi"
  24.  icon.  This reinstalls avmNfax using the second option.  Wait a couple
  25.  of seconds, and then reboot your machine to make the new configuration
  26.  take effect.  Please send me email if you still cannot get avmNfax
  27.  to work.  I should be able to determine from the logger.save files
  28.  whether your modem is actually compatible with avmNfax.
  29.  
  30.  If you have a fax-modem only, you may skip certain steps that
  31.  I've marked as skippable.
  32.  
  33.  1.  Hardware setup
  34.  
  35.   Plug your modem into the serial port.  I highly recommend getting
  36.   a cable which has the required 7 wires.
  37.  
  38.   Determine what type of modem you have.  To do this, open up
  39.   a terminal program (Terminus, Termite, Term, JR Comm, Baud Bandit,
  40.   vt100, ATalk III, etc.).  Then, type in the following commands
  41.   followed by a <Return>:
  42.  
  43.   AT+FCLASS=8
  44.                 ; If this returns OK, then you have a ZyXEL or Dolphin.
  45.  
  46.   AT#VS4
  47.                 ; If this does NOT return an ERROR, then you probably
  48.                   have a LineLink.
  49.   AT#CLS=8
  50.                 ; If this returns OK, then you have a Rockwell compatible
  51.                   voice modem.  Someone says this returns OK on a ZyXEL
  52.                   too...but you would know that you have a ZyXEL.
  53.  
  54.   If any of the tests above works for you, then you have something that
  55.   is most likely supported by the voicemail portion of this package.
  56.   Great!
  57.  
  58.   If none of these commands work, then you may have a fax modem.
  59.   To determine what "class" it supports, type in the following:
  60.  
  61.   AT+FCLASS=1
  62.                 ; If this returns OK, then you have a Class 1
  63.                   fax modem.
  64.   AT+FCLASS=2
  65.                 ; If this returns OK, then you have a Class 2
  66.                   fax modem.
  67.   AT+FCLASS=2.0
  68.                 ; If this returns OK, then you have a Class 2.0
  69.                   fax modem.  THIS IS NOT SUPPORTED.
  70.  
  71.   Currently, EFax (the included fax software) only supports Class 1
  72.   and Class 2 fax modems.  Class 2.0 is not yet supported.
  73.  
  74.   a. If you have a voice-capable modem,
  75.  
  76.      If you have a Rockwell based modem that has a connector for
  77.      a telephone at the back of the modem, connect your telephone
  78.      there.
  79.  
  80.      If you have a Zyxel Elite (2864), connect your telephone to
  81.      the back of the modem.
  82.  
  83.      Otherwise, you will need to connect your telephone to some sort
  84.      of splitter.  The telephone should be connected in *parallel*
  85.      with the modem.  It should not be connected to the back of the
  86.      modem!  Another possibility is to hook it up to an extension
  87.      in your house.  To test whether the telephone and the modem
  88.      are hooked up as required by AVM, call up some BBS in your area.
  89.      Once you are connected, pick up the telephone.  If you hear the
  90.      modem noises, then your setup is OK.
  91.  
  92.   b. If you have a fax-modem,
  93.  
  94.      You can plug a telephone to the back of the modem or on
  95.      a separate extension.  It does not matter.
  96.  
  97.  2.  Install MUI 3.6 or greater and ensure that it works by trying
  98.      out one of the MUI demos.  If you cannot get one of the demos
  99.      to work, you can be sure that AVM won't work either.
  100.  
  101.      Note that when installing MUI, you need to use the MUI-Install
  102.      icon.  You cannot just copy the muimaster.library to LIBS:.
  103.      That will not work.  Typical errors if you mis-install MUI include
  104.      "Bad window object" and "Can't find muimaster.library" messages
  105.      when trying to run one of the MUI-based applications in
  106.      avmNfax.  If none of the MUI demos work, then you should
  107.      work on that first.
  108.  
  109.      I cannot over-emphasize the requirement that you install MUI
  110.      correctly.
  111.  
  112.  3.  Make sure that ARexx is running.  To do this, type in the
  113.      following into a Shell:
  114.  
  115.      sys:rexxc/rx "say hello"
  116.  
  117.      If "HELLO" is printed, ARexx is running.  If not, you need to
  118.      run the ARexx server by typing the following into a Shell:
  119.  
  120.      rexxmast > NIL:
  121.  
  122.      I recommend that you add the previous line (rexxmast ...) to
  123.      s:startup-sequence or s:user-startup.
  124.  
  125.  4.  Unarchive the main avmNfax archive in some temporary directory.
  126.      To do this, you normally do the following from a Shell:
  127.  
  128.      lha x avmNfax?.??.lha
  129.  
  130.      where ?.?? should be replaced with the version you're
  131.      trying to install.
  132.  
  133.      This step will create a directory called AVMInstall in the
  134.      directory that you were "in" at the time you executed
  135.      this command.
  136.  
  137.      My installation procedure will copy files to the final destination.
  138.  
  139.      I normally unarchive the main archive in RAM:.  However, if you
  140.      do not have a lot of RAM, then any place on your hard drive
  141.      is fine.
  142.  
  143.  5.  Double-click on the AVM-Install icon from the WorkBench.  This
  144.      will give you a lot of options.  Answer the questions as best
  145.      as you can.
  146.  
  147.      This step will copy the necessary files from the temporary
  148.      directory (where you unarchived the avmNfax archive) to the
  149.      final directory and add the necessary ASSIGNs to your user-startup
  150.      file (you should *always* Proceed when asked if you want to
  151.      add the necessary ASSIGNs to the user-startup file).  You will
  152.      also be able to choose what type of modem you have, what type
  153.      of digitizer, and the method by which you want to be informed
  154.      of new calls, among other things.
  155.  
  156.      Note:  Fax-modem owners should check if their modem is listed
  157.      as one of the options.  If it is, then someone else has the same
  158.      modem that you have and was able to make it work with EFax.
  159.      By using the configuration that was sent to me, you should be
  160.      able to get your modem working with EFax.  If it is not listed,
  161.      you should still be able to get EFax working with your modem
  162.      by choosing Class 2 or Class 1 (if your fax modem supports both
  163.      Class 2 and Class 1, try Class 2 first).
  164.  
  165.  6.  Configure AVM.  To perform this step, click on the icon called
  166.      startAVM in the directory that you just installed avmNfax.
  167.      A window called "AVM UserInterface" will open.  Go to the
  168.      Configure menu and select "Servers".  Another window will open
  169.      up called "Choose Server".  Click on the Configure button at the
  170.      bottom of the window.  Another window called "Configure Server"
  171.      should open up.  Make sure that the gadget at the top of this
  172.      window is called Common.
  173.  
  174.      a.  Set up the serial port parameters
  175.  
  176.        Edit the field called Serial Port and change it
  177.        from serial.device to the name of the device your
  178.        modem is hooked up to.  You should also change the
  179.        Unit Number if it is not 0.
  180.  
  181.      b.  Set up the ring parameters
  182.  
  183.        Adjust the number of rings that you want AVM to wait for
  184.        before answering the phone if there are messages in some
  185.        of the mailboxes.
  186.  
  187.        Adjust the number of rings that you want AVM to wait for
  188.        before answering the phone if there are no messages in
  189.        any of the mailboxes.
  190.  
  191.      c.  Set up the fax parameters
  192.  
  193.        Cycle the gadget at the top of the Configure Server window
  194.        until it says "Fax".
  195.  
  196.        Enter your Fax ID in the field called Fax ID.  Do this if
  197.        you use either EFax or TrapFax.  For other fax programs
  198.        such as GPFax, use those programs to set the Fax ID.
  199.  
  200.      Once you have made the necessary changes, click on the Save
  201.      button at the bottom of the Configure Server window.
  202.  
  203.  7.  Required fax setup if you are not going to use EFax.
  204.  
  205.      To use GPFax with AVM, follow these steps to configure
  206.      GPFax:
  207.  
  208.        g1. Make sure that the Shared flag is enabled in the 
  209.            Environment window of GPFax.
  210.  
  211.        g2. Edit the Answer.gpf script and remove the lines
  212.            which have 'viewlast' in them (the last two ones in
  213.            the version I have).
  214.  
  215.        g3. If you have a ZyXEL modem, the Modem Init string of GPFax
  216.            should be:
  217.  
  218.            AATE0V1X4&K3&C1&D2S0=0
  219.  
  220.        g4. If you have a LineLink modem, the Modem Init string GPFax
  221.            should be:
  222.  
  223.            AATE0V1X4&K3&C1&D2&R0S0=0
  224.  
  225.        g5. If you have any other modem, try the one for the ZyXEL
  226.            modem first.  Then try the one for the LineLink modem.
  227.  
  228.        g6. Edit avm:StandardConfig.  Add the following line to the
  229.            end of that file:
  230.  
  231.            sys:rexxc/rxset AVMFaxProgram GPFax
  232.  
  233.            Save the file after making this change.
  234.  
  235.        NOTE:  GPFax should not be running before you start AVM.
  236.  
  237.      To use TrapFax with AVM, follow these steps to configure
  238.      TrapFax and AVM:
  239.  
  240.        t1. Note!  This step may not be necessary -- try using TrapFax
  241.            without doing this step first.
  242.  
  243.            Make sure that you install the OwnDevUnit library.
  244.  
  245.            Open up the Configure Server window as you did in Step
  246.            6.  Edit the Common settings by cycling through the gadget
  247.            at the top of the Configure Server window.  Enable
  248.            the checkbox called Use OwnDevUnit.  Click on the Save
  249.            button at the bottom of the Configure Server window,
  250.            wait 10 seconds, then reboot you Amiga.
  251.  
  252.        t2. Edit avm:StandardConfig.  Add the following line to the
  253.            end of that file:
  254.  
  255.            sys:rexxc/rxset AVMFaxProgram TrapFax
  256.  
  257.            Save the file after making this change.
  258.  
  259.  8.  Start up AVM by double clicking on the startAVM icon.  Or,
  260.      type in "execute avm:startAVM" from some Shell.  Two programs
  261.      should start up:  the AVM UserInterface, and the AVM Server.
  262.      The AVM Server is the program that communicates with the modem.
  263.      It is required for proper operation of AVM.  This is the only
  264.      program that is required if you want your Amiga to answer
  265.      the phone, act as a voicemail machine, do faxes, etc.  The
  266.      AVM UserInterface allows you to access your voice and fax
  267.      messages.     
  268.  
  269.  9.  Skip this step if you have a fax modem only.
  270.  
  271.      Skip this step if you already have an old version of avmNfax
  272.      installed.
  273.  
  274.      Record your voice prompts.  To do this, go to the Configure
  275.      menu and select the Voice Prompts menu item.  Alternatively,
  276.      you can download the optional voice files.
  277.  
  278.   a. Simple answering machine
  279.  
  280.      If you want a really simple answering machine, you only
  281.      need to record the following files:
  282.  
  283.       o  intro1
  284.       o  intro2
  285.       o  intro3
  286.       o  MailboxGreeting
  287.       o  MailboxCaller
  288.       o  SkipFaxMaintenance
  289.       o  BeingForwarded
  290.       o  AnnounceForward
  291.       o  AnnounceAgain
  292.       o  Goodbye
  293.       o  0, 1, 2, 3, 4, 5, 6, 7, 8, 9
  294.  
  295.      The "intro" files are played first (depending on the time of day)
  296.      After one of the "intro" files is played, the caller is put into
  297.      the "Anonymous" mailbox, which plays "MailboxGreeting", at which
  298.      point the caller can send a fax or wait for the beep to leave
  299.      a message.  It is entirely up to you on what message you want
  300.      to tell him.  Maybe you could say something like "Hi, this is
  301.      Al's answering machine.  Press 2 to send a fax or wait for the
  302.      beep and leave your message.  When you're done leaving your
  303.      message, press 1.".  If the caller presses 1, then he will be
  304.      allowed to do other things like leave another message.
  305.  
  306.      Note that when I mean a "simple answering machine", I really 
  307.      mean simple.  You will not be able to call your system to
  308.      retrieve your messages or do any remote maintenance.
  309.      For that, you will have to record many more voice files.
  310.  
  311.      If you downloaded the optional voice files, you will probably only
  312.      want to re-record the following voice file:
  313.  
  314.       o  MailboxGreeting
  315.  
  316.   b. Three mailbox system
  317.  
  318.      If you are running AVM as the three mailbox system, you need
  319.      to record the following files:
  320.  
  321.       o  intro1
  322.       o  intro2
  323.       o  intro3
  324.       o  MailboxGreeting
  325.       o  MailboxCaller
  326.       o  SkipFaxMaintenance
  327.       o  BeingForwarded
  328.       o  AnnounceForward
  329.       o  AnnounceAgain
  330.       o  Goodbye
  331.       o  InitialMessage
  332.       o  level0
  333.  
  334.      "InitialMessage" tells the caller to press 1 to enter the
  335.      voicemail system.  If he does press 1, "level0" then asks
  336.      the caller to press a number depending on who they may leave
  337.      messages or faxes for.  Unless your names happen to be Al and
  338.      Dory, you will need to re-record this message :)  Also, you
  339.      really should record "level0".
  340.  
  341.      With this minimal set of voice files, you will not be able
  342.      to retrieve your messages from the outside or do any
  343.      maintenance from the outside.  For that, you will have to
  344.      record many more voice files.
  345.  
  346.      If you got the optional voice files, then will probably only
  347.      want to re-record the following voice files:
  348.  
  349.       o  MailboxGreeting
  350.       o  level0
  351.  
  352.  10. Skip this step if you have a fax-modem only.
  353.  
  354.      Test things out.
  355.  
  356.      Test 1:  Pick up the phone, dial a 1 digit number on the
  357.      telephone (this should get rid of the dial tone), the press
  358.      the icon that looks like a tape recorder (it is the icon to
  359.      the right of the mouth).  Talk into the handset for a few
  360.      seconds then click on the button that looks like an
  361.      exclamation point.  You should be able to play the message
  362.      that got created in the Manual mailbox.
  363.  
  364.      Test 2:  Pick up your phone, wait a few minutes until
  365.      the phone company gives up and makes your phone line go silent,
  366.      then click on the icon that looks like a mouth.  This will
  367.      instruct AVM to pick up the phone and process it as though
  368.      you got a call.  Try leaving a message.  Then wait for AVM to
  369.      hang up.  Then click on the mouth icon again and try to retrieve
  370.      your message using the touch tone keys (do this only if you
  371.      recorded all of the necessary voice prompts).
  372.  
  373.      NOTE:  On some phone systems, this will not work.  It depends
  374.      on the phone company.
  375.  
  376.  11. To run AVM automatically when your computer reboots or is powered
  377.      on, you can drag and drop the startAVM icon into your
  378.      WBStartup drawer.
  379.  
  380.  12. The file called StandardConfig in the AVMSuite2 directory should
  381.      be edited to your preferences.  In particular, when you first install
  382.      AVM, it defaults to acting like a simple answering machine.  If you
  383.      want to try out the multi-mailbox system, you will need to add
  384.      something to this file.  There are also other parameters in this
  385.      file that you can change to alter the way AVM and its ARexx
  386.      scripts work.  See the section "Configuring with RXSET or SETENV"
  387.      in the avm.doc or avm.guide file to see what the different lines
  388.      in this file means.  NOTE!  You will need to quit all the AVM
  389.      programs and restart AVM using startAVM in order for your new
  390.      configuration to take effect.
  391.  
  392.      Here are some of the things you can set:
  393.  
  394.        o The BBS that you want run when a caller presses 5
  395.        o The Fax program that you want run when caller presses 2
  396.        o The font and font size that is used when you print out text
  397.          through the fax printer-driver
  398.        o Whether to use a user-recorded beep
  399.        o Whether to do pre-conversion
  400.        o The date and time format that will be displayed in LogViews,
  401.          SchedulerViews, or the Scheduler
  402.        o and so on...
  403.  
  404.  13. Skip this step if you have a fax-modem only.
  405.  
  406.      If you got the archive avmNfaxProg?.??.lha (this is the Programmer
  407.      and its associated "source" files -- make sure you have the same
  408.      version as the main avmNfax archive), do the following from a Shell:
  409.  
  410.        cd avm:
  411.        lha x avmNfaxprog?.??.lha
  412.  
  413.      where ?.?? is the version that you got.  You may want to backup
  414.      your source files first though, in case you made some modifications.
  415.  
  416.  14. Erase the directory that was created when you unarchived the
  417.      main avmNfax archive.  You do not need that directory anymore
  418.      since the installation program copied the stuff to the final
  419.      destination.
  420.  
  421.  15. ATTENTION!  avmNfax 2.xx will install in a different directory
  422.      than 1.xx.  In particular, it will install in a directory called
  423.      AVMSuite2 instead of the old directory called AVMSuite.  After
  424.      installing 2.xx, you should copy the keyfiles and the voice files
  425.      into the new directory:
  426.  
  427.        copy work:AVMSuite/owner.cfg work:AVMSuite2
  428.        copy work:AVMSuite/#?key work:AVMSuite2
  429.        copy work:AVMSuite/voices work:AVMSuite2/voices
  430.  
  431.